.. _cmmCfgSetSpeedRange:

cmmCfgSetSpeedRange
======================
----------------------

SYNOPSYS
```````````

.. code-block:: none

    VT_I4 cmmCfgSetSpeedRange(
        [in] VT_I4 Axis, [in] VT_R8 MaxPPS
        )

DESCRIPTION
`````````````

- cmmCfgSetSpeedRange() 함수는 모션에 적용할 수 있는 최저/최고 속도를 제한합니다. 이 함수느 실제적으로는 출력 펄스의 주파수 범위를 설정하는 역할을 합니다.


PARAMETER
`````````````

- Axis: 축번호. 축번호는 상수값으로 [cmX1] 부터 0 번째 축을 기준 축으로 임의의 축을 설정할 수 있습니다.

\

- MaxPPS : cmmCfgSetSpeedRange 함수의 인자이며, 모션의 최고 속도를 PPS 로 설정합니다. 


.. warning:: MaxPPS 값을 설정할 때는 Unit speed 설정에 관계없이 항상 PPS 단위로 설정하여야 합니다.

\

- MinPPS : 모션의 최저 속도를 PPS 단위로 반환합니다. 사용자는 모션의 최저 속도를 참조만 할 수 있으며
  사용자가 직접 설정할 수는 없습니다. 왜냐하면 최저속도는 최고 속도를 설정함에 따라서 자동으로 설정되기
  때문입니다. 최저 속도와 최고 속도의 다음과 같습니다.

  MinPPS = MaxPPS / 65,535
  예를 들어서 MaxPPS 가 655,350 이면 MinPPS = 655,350 / 65,535 = 10 (PPS)이 됩니다.



EXAMPLE
`````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

 C/C++

 #include “Cmmsdk.h”
 #include “CmmsdkDef.h”

 void OnSetSpeedRange ()
 {
    long nAxisNo = 1; // 모션 속도 제한 범위를 설정할 축을 선택합니다.
    double fMaxPPS, fMinPPS; // 최저/최고 모션 속도 정보

    /* 모션 최고 속도 정보를 확인 후, 모션 최고 속도를 6.5MPPS 로 설정합니다. 
    모션 최고 속도를 6.5MPPS 로 설정하면 모션 속도의 범위는 100 ~ 6553500 PPS 이 됩니다. */

    if(cmmCfgGetSpeedRange ( nAxisNo, &fMinPPS, &fMaxPPS ) == cmERR_NONE )
    {
        if ( fMaxPPS < 6553500 )
        {
             // 모션 최대 속도를 6553500 으로 설정합니다.
             cmmCfgSetSpeedRange ( nAxisNo, 6553500 );
        }
    }
 }


.. code-block:: none
 :linenos:

 Visual Basic

 Private Sub OnSetSpeedRange ()

    Dim nAxisNo As Long ‘ 모션 속도 제한 범위를 설정할 축을 선택합니다.
    Dim fMaxPPS As Double, fMinPPS As Double ‘ 최저/최고 모션 속도 정보

    nAxisNo = 1

    ‘   모션 최고 속도 정보를 확인 후, 모션 최고 속도를 6.5MPPS 로 설정합니다. 
    ‘ 모션 최고 속도를 6.5MPPS 로 설정하면 모션 속도의 범위는 100 ~ 6553500 PPS 이 됩니다.
    If cmmCfgGetSpeedRange ( nAxisNo, fMinPPS, fMaxPPS ) = cmERR_NONE Then

        If fMaxPPS < 6553500 Then
            ‘ 모션 최대 속도를 6553500 으로 설정합니다.
            Call cmmCfgSetSpeedRange ( nAxisNo, 6553500 )
        End If
    End If

 End Sub


.. code-block:: none
 :linenos:

 Delphi

 procedure OnSetSpeedRange ();
 var
    nAxisNo : LongInt; // 모션 속도 제한 범위를 설정할 축을 선택합니다.
    fMaxPPS, fMinPPS : Double; // 최저/최고 모션 속도 정보

 begin
    nAxisNo := 1;

    { 모션 최고 속도 정보를 확인 후, 모션 최고 속도를 6.5MPPS 로 설정합니다. 
    모션 최고 속도를 6.5MPPS 로 설정하면 모션 속도의 범위는 100 ~ 6553500 PPS 이 됩니다. }
    if cmmCfgGetSpeedRange ( nAxisNo, @fMinPPS, @fMaxPPS ) = cmERR_NONE then
    begin
        if fMaxPPS < 6553500 then
        begin
            // 모션 최대 속도를 6553500 으로 설정합니다.
            cmmCfgSetSpeedRange ( nAxisNo, 6553500 );
        end;
    end;

 end;




.. seealso:: :ref:`cmmCfgGetSpeedRange`